home *** CD-ROM | disk | FTP | other *** search
/ The Fatted Calf / The Fatted Calf.iso / Applications / Developer / BBFig / README
Text File  |  1993-04-12  |  5KB  |  104 lines
  1. BBFig version 1.2 [92-5-14]
  2.  
  3. One-line description:
  4. Utility to compute %%BoundingBox of a 1-page PostScript drawing.
  5.  
  6. Archive maintainer(s):
  7. This is a full source package of a NeXTstep app for Release 2.0/2.1.
  8. Please move to an appropriate directory on your archive.
  9. The previous version if BBFig should be removed.
  10.  
  11. *********************************************************************
  12. What's new in v1.2
  13. * Point grid in the background in the output window.
  14. * Find/Replace panel for the PS document text(Thanks to D. Holscher).
  15. * Preferences for reverting to Yap, turning on/off grid, BoundingBox
  16.      margin settings.
  17. *********************************************************************
  18.  
  19. Introduction:
  20.  
  21. BBFig is a utility which computes the BoundingBox information from
  22. PostScript.  This information is required for EPS (Encapsulated
  23. PostScript) files as a comment of the form, for example: 
  24. %%BoundingBox: 10 10 300 500
  25. The bounding box comment can be added easily to the PostScript file
  26. with the editor included with BBFig. (For details about %%BoundingBox,
  27. see Apendices G and H of the PostScript Red Book: PostScript Language
  28. Reference Manual, 2-nd ed. Addison-Wesley, ISBN 0-201-18127-4.) BBFig is
  29. also an improved Yap (Yet Another Previewer for PostScript) by Ali
  30. Ozer.  A number of bugs in Yap have been fixed. 
  31.  
  32. Use BBFig only for a single page document (just in case you don't know
  33. that already). 
  34.  
  35.  
  36. Usage:
  37.  
  38. [1] Open PS files with the Document > Open menu option.  You can have
  39. mutiple PS files open at the same time.
  40.  
  41. [2] Press Execute to execute the contents of the selected window.  The
  42. rendered page is displayed in the output window, with the bounding box
  43. indicated by a dashed rectangle.  There's only one output window, whose
  44. PostScript rendering area can be resized through the Preferences panel.
  45.   If there are any PostScript errors, the first error is reported in
  46. the title bar of the output window.  If there are no errors in the
  47. execution of  the PS code, then the time needed for imaging the PS code
  48. will be reported instead.   The computed BoundingBox is stuffed into a
  49. field just below the scroll view containing the PS code.
  50.  
  51. [3] To insert %%BoundingBox comment, position the text cursor at the
  52. desired insertion point, and press Insert button next to the field
  53. containing the line.  For convenience, The EPS version comment
  54. "%!PS-Adobe...." and the bounding box comment may be inserted at the
  55. top of the document by pressing Both button.
  56.  
  57. [4] Save the PS file by Document > Save menu option.  If you wish to
  58. change the filename from *.ps to *.eps, use Save As.
  59.  
  60. If you change the font in a BBFig Document window, the same font will
  61. be used for BBFig windows used after that point. The font will also be
  62. written out to your defaults database to be used the next time you
  63. launch BBFig.
  64.  
  65. BBFig can paste PostScript from the pasteboard.  This can come in handy
  66. when debugging programs that write PostScript on the pasteboard. The
  67. Paste menu command will first check the pasteboard for PostScript data,
  68. then for text data.
  69.  
  70.  Preferences Options:
  71.  
  72. Bounding Box Margin is used to expand the bounding box slightly larger
  73. than the limits of the actual drawing.  If no margin is given,
  74. importing applications may sometimes clip the graphics too closely. 
  75. The bounding box specification will be expanded by the number of points
  76. specified by this slider.  This setting will be saved in your default
  77. database.  All other settings below are temporary and apply only as
  78. long as you keep the BBFig running. Compute Bounding Box toggle switch
  79. controls whether the bounding box information is computed.  BBFig will
  80. revert to Yap when you turn off the check mark. Show Grid toggle switch
  81. turns on or off the point grid displayed in the PostScript output
  82. window.  The grid may be useful when BBFig fails to determine the
  83. bounding box correctly, or when you want to adjust it manually.
  84.  
  85.  Bugs:
  86.  
  87. BBFig is a NeXTstep version of bbfig by Bernie Cosell.  The ability of
  88. BBFig to figure out the bounding box information is the same as that of
  89. the original bbfig.   With the current version, it may fail on many PS
  90. files.
  91.  
  92.  Acknowledgements:
  93.  
  94. BBFig is just an extended version of Yap found in
  95. /NextDeveloper/Examples/Yap, which contains the source files for Yap.  
  96. I have incorporated a PD utility bbfig by Bernie Cosell 
  97. [cosell@bbn.com] into Yap via pswrap.  As new improved versions of
  98. bbfig become available, they may be incorporated easily thanks to
  99. pswrap.  BBFig.psw is the module which contains Bernie's code. 
  100.  
  101. Send comments, bug reports to Izumi Ohzawa,
  102. izumi@pinoko.berkeley.edu
  103.  
  104.